package org.goodsmanager.service;

import org.goodsmanager.entity.OperationLog;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 操作日志服务接口
 *
 * @author Goods Manager System
 * @version 1.0.0
 */
public interface OperationLogService {

    /**
     * 记录操作日志
     */
    void recordLog(OperationLog operationLog);

    /**
     * 根据ID删除操作日志
     */
    boolean deleteLogById(String id);

    /**
     * 批量删除操作日志
     */
    boolean batchDeleteLogs(List<String> ids);

    /**
     * 根据ID查询操作日志
     */
    OperationLog getLogById(String id);

    /**
     * 分页查询操作日志
     */
    List<OperationLog> getLogsByPage(int pageNum, int pageSize, String userId, String operationType, 
                                     String module, String status, LocalDateTime startTime, 
                                     LocalDateTime endTime, String keyword);

    /**
     * 查询操作日志总数
     */
    int getLogCount(String userId, String operationType, String module, String status, 
                    LocalDateTime startTime, LocalDateTime endTime, String keyword);

    /**
     * 清理指定天数之前的日志
     */
    boolean cleanLogsBefore(int days);

    /**
     * 统计各类型操作数量
     */
    List<Map<String, Object>> countByOperationType(LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 统计各模块操作数量
     */
    List<Map<String, Object>> countByModule(LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 统计用户操作数量
     */
    List<Map<String, Object>> countByUser(LocalDateTime startTime, LocalDateTime endTime, int limit);

    /**
     * 导出操作日志
     */
    List<OperationLog> exportLogs(String userId, String operationType, String module, String status, 
                                  LocalDateTime startTime, LocalDateTime endTime, String keyword);
}